Developer CD Series 1995 June: Reference Library/Dev.CD Jun 95/Dev.CD Jun 95.toast/What's New?/New System Software Extensions/QuickDraw 3D ß/Programming/Interfaces/QD3DTransform.h

C/C++ Source or Header | 1995-04-04 | 9.0 KB | 308 lines | [TEXT/MPS ]

/******************************************************************************
 **                                                                             **
 **     Module:        QD3DTransform.h                                             **
 **                                                                          **
 **                                                                          **
 **     Purpose:     Transform routines                                          **
 **                                                                          **
 **                                                                          **
 **     Copyright (C) 1991-1994 Apple Computer, Inc. All rights reserved.     **
 **                                                                          **
 **                                                                          **
 *****************************************************************************/
#ifndef QD3DTransform_h
#define QD3DTransform_h

#if PRAGMA_ONCE
    #pragma once
#endif

#ifdef __cplusplus
extern "C" {
#endif    /* __cplusplus */

/******************************************************************************
 **                                                                             **
 **                            Transform Routines                                 **
 **                                                                             **
 *****************************************************************************/

EXPORT TQ3ObjectType Q3Transform_GetType(
    TQ3TransformObject    transform);

EXPORT TQ3Matrix4x4 *Q3Transform_GetMatrix(
    TQ3TransformObject    trasform,
    TQ3Matrix4x4            *matrix);

EXPORT TQ3Status Q3Transform_Submit(
    TQ3TransformObject    transform,
    TQ3ViewObject        view);


/******************************************************************************
 **                                                                             **
 **                            MatrixTransform Routines                         **
 **                                                                             **
 *****************************************************************************/

EXPORT TQ3TransformObject Q3MatrixTransform_New(
    const TQ3Matrix4x4     *matrix);

EXPORT TQ3Status Q3MatrixTransform_Submit(
    const TQ3Matrix4x4     *matrix,
    TQ3ViewObject        view);

EXPORT TQ3Status Q3MatrixTransform_Set(
    TQ3TransformObject    transform,
    const TQ3Matrix4x4      *matrix);

EXPORT TQ3Status Q3MatrixTransform_Get(
    TQ3TransformObject    transform,
    TQ3Matrix4x4            *matrix);


/******************************************************************************
 **                                                                             **
 **                            RotateTransform Data                             **
 **                                                                             **
 *****************************************************************************/

typedef struct TQ3RotateTransformData {
    TQ3Axis                axis;
    float                radians;
} TQ3RotateTransformData;


/******************************************************************************
 **                                                                             **
 **                            RotateTransform Routines                         **
 **                                                                             **
 *****************************************************************************/

EXPORT TQ3TransformObject Q3RotateTransform_New(
    const TQ3RotateTransformData    *data);


EXPORT TQ3Status Q3RotateTransform_Submit(
    const TQ3RotateTransformData    *data,
    TQ3ViewObject                view);

EXPORT TQ3Status Q3RotateTransform_SetData(
    TQ3TransformObject            transform,
    const TQ3RotateTransformData    *data);

EXPORT TQ3Status Q3RotateTransform_GetData(
    TQ3TransformObject            transform,
    TQ3RotateTransformData        *data);

EXPORT TQ3Status Q3RotateTransform_SetAxis(
    TQ3TransformObject            transform,
    TQ3Axis                        axis);

EXPORT TQ3Status Q3RotateTransform_SetAngle(
    TQ3TransformObject            transform,
    float                        radians);

EXPORT TQ3Status Q3RotateTransform_GetAxis(
    TQ3TransformObject             renderable,
    TQ3Axis                         *axis);

EXPORT TQ3Status Q3RotateTransform_GetAngle(
    TQ3TransformObject             transform,
    float                         *radians);


/******************************************************************************
 **                                                                             **
 **                    RotateAboutPointTransform Data                             **
 **                                                                             **
 *****************************************************************************/

typedef struct TQ3RotateAboutPointTransformData {
    TQ3Axis                        axis;
    float                        radians;
    TQ3Point3D                    about;
} TQ3RotateAboutPointTransformData;


/******************************************************************************
 **                                                                             **
 **                    RotateAboutPointTransform Routines                         **
 **                                                                             **
 *****************************************************************************/

EXPORT TQ3TransformObject Q3RotateAboutPointTransform_New(
    const TQ3RotateAboutPointTransformData    *data);

EXPORT TQ3Status Q3RotateAboutPointTransform_Submit(
    const TQ3RotateAboutPointTransformData    *data,
    TQ3ViewObject                            view);

EXPORT TQ3Status Q3RotateAboutPointTransform_SetData(
    TQ3TransformObject                        transform,
    const TQ3RotateAboutPointTransformData    *data);

EXPORT TQ3Status Q3RotateAboutPointTransform_GetData(
    TQ3TransformObject                        transform,
    TQ3RotateAboutPointTransformData            *data);

EXPORT TQ3Status Q3RotateAboutPointTransform_SetAxis(
    TQ3TransformObject                        transform,
    TQ3Axis                                    axis);

EXPORT TQ3Status Q3RotateAboutPointTransform_GetAxis(
    TQ3TransformObject                        transform,
    TQ3Axis                                    *axis);


EXPORT TQ3Status Q3RotateAboutPointTransform_SetAngle(
    TQ3TransformObject                        transform,
    float                                    radians);

EXPORT TQ3Status Q3RotateAboutPointTransform_GetAngle(
    TQ3TransformObject                        transform,
    float                                    *radians);


EXPORT TQ3Status Q3RotateAboutPointTransform_SetAboutPoint(
    TQ3TransformObject                        transform,
    const TQ3Point3D                            *about);

EXPORT TQ3Status Q3RotateAboutPointTransform_GetAboutPoint(
    TQ3TransformObject                        transform,
    TQ3Point3D                                *about);


/******************************************************************************
 **                                                                             **
 **                    RotateAboutAxisTransform Data                             **
 **                                                                             **
 *****************************************************************************/

typedef struct TQ3RotateAboutAxisTransformData {
    TQ3Point3D            origin;
    TQ3Vector3D            orientation;
    float                radians;
} TQ3RotateAboutAxisTransformData;


/******************************************************************************
 **                                                                             **
 **                    RotateAboutAxisTransform Routines                         **
 **                                                                             **
 *****************************************************************************/

EXPORT TQ3TransformObject Q3RotateAboutAxisTransform_New(
    const TQ3RotateAboutAxisTransformData    *data);

EXPORT TQ3Status Q3RotateAboutAxisTransform_Submit(
    const TQ3RotateAboutAxisTransformData    *data,
    TQ3ViewObject                            view);

EXPORT TQ3Status Q3RotateAboutAxisTransform_SetData(
    TQ3TransformObject                        transform,
    const TQ3RotateAboutAxisTransformData    *data);

EXPORT TQ3Status Q3RotateAboutAxisTransform_GetData(
    TQ3TransformObject                        transform,
    TQ3RotateAboutAxisTransformData            *data);


EXPORT TQ3Status Q3RotateAboutAxisTransform_SetOrientation(
    TQ3TransformObject                        transform,
    const TQ3Vector3D                        *axis);

EXPORT TQ3Status Q3RotateAboutAxisTransform_GetOrientation(
    TQ3TransformObject                        transform,
    TQ3Vector3D                                *axis);


EXPORT TQ3Status Q3RotateAboutAxisTransform_SetAngle(
    TQ3TransformObject                        transform,
    float                                    radians);

EXPORT TQ3Status Q3RotateAboutAxisTransform_GetAngle(
    TQ3TransformObject                        transform,
    float                                    *radians);


EXPORT TQ3Status Q3RotateAboutAxisTransform_SetOrigin(
    TQ3TransformObject                        transform,
    const TQ3Point3D                            *origin);

EXPORT TQ3Status Q3RotateAboutAxisTransform_GetOrigin(
    TQ3TransformObject                        transform,
    TQ3Point3D                                *origin);


/******************************************************************************
 **                                                                             **
 **                            ScaleTransform Routines                             **
 **                                                                             **
 *****************************************************************************/

EXPORT TQ3TransformObject Q3ScaleTransform_New(
    const TQ3Vector3D        *scale);

EXPORT TQ3Status Q3ScaleTransform_Submit(
    const TQ3Vector3D        *scale,
    TQ3ViewObject            view);

EXPORT TQ3Status Q3ScaleTransform_Set(
    TQ3TransformObject        transform,
    const TQ3Vector3D        *scale);

EXPORT TQ3Status Q3ScaleTransform_Get(
    TQ3TransformObject        transform,
    TQ3Vector3D                *scale);


/******************************************************************************
 **                                                                             **
 **                            TranslateTransform Routines                         **
 **                                                                             **
 *****************************************************************************/

EXPORT TQ3TransformObject Q3TranslateTransform_New(
    const TQ3Vector3D        *translate);

EXPORT TQ3Status Q3TranslateTransform_Submit(
    const TQ3Vector3D        *translate,
    TQ3ViewObject            view);

EXPORT TQ3Status Q3TranslateTransform_Set(
    TQ3TransformObject        transform,
    const TQ3Vector3D        *translate);

EXPORT TQ3Status Q3TranslateTransform_Get(
    TQ3TransformObject        transform,
    TQ3Vector3D                *translate);

/******************************************************************************
 **                                                                             **
 **                            QuaternionTransform Routines                     **
 **                                                                             **
 *****************************************************************************/

EXPORT TQ3TransformObject Q3QuaternionTransform_New(
    const TQ3Quaternion        *quaternion);

EXPORT TQ3Status Q3QuaternionTransform_Submit(
    const TQ3Quaternion        *quaternion,
    TQ3ViewObject            view);

EXPORT TQ3Status Q3QuaternionTransform_Set(
    TQ3TransformObject        transform,
    const TQ3Quaternion         *quaternion);

EXPORT TQ3Status Q3QuaternionTransform_Get(
    TQ3TransformObject        transform,
    TQ3Quaternion            *quaternion);


#ifdef __cplusplus
}
#endif    /* __cplusplus */

#endif  /*  QD3DTransform_h  */